---
title: Referencia de la API de variables de entorno
sidebar:
  label: 'astro:env'
i18nReady: true
tableOfContents:
  minHeadingLevel: 2
  maxHeadingLevel: 6
---
import Since from '~/components/Since.astro';
import ReadMore from '~/components/ReadMore.astro';

<p><Since v="5.0.0" /></p>

La API `astro:env` te permite configurar un esquema seguro para las variables de entorno que hayas establecido. Esto te permite indicar si deben estar disponibles en el servidor o en el cliente, y definir su tipo de datos y propiedades adicionales. Para ver ejemplos e instrucciones de uso, [consulta la guía de `astro:env`](/es/guides/environment-variables/#variables-de-entorno-con-seguridad-de-tipos).

## Importaciones desde `astro:env`

```js
import { 
  getSecret,
 } from 'astro:env/server';
```

### `getSecret()`

<p>
<Since v="5.0.0" />
</p>

La función auxiliar `getSecret()` permite recuperar el valor bruto de una variable de entorno mediante su clave.

Por ejemplo, puedes recuperar un valor booleano como una cadena de texto:

```js
import {
  FEATURE_FLAG, // boolean
  getSecret
} from 'astro:env/server'

getSecret('FEATURE_FLAG') // string | undefined
```

Esto también puede ser útil para obtener un secreto no definido en tu esquema, por ejemplo, uno que dependa de datos dinámicos de una base de datos o API.

Si necesitas recuperar variables de entorno mediante programación, te recomendamos utilizar `getSecret()` en lugar de `process.env` (o equivalente). Dado que su implementación la proporciona tu adaptador, no tendrás que actualizar todas tus llamadas si cambias de adaptador. El valor predeterminado es `process.env` en dev y build.
